home *** CD-ROM | disk | FTP | other *** search
/ Language/OS - Multiplatform Resource Library / LANGUAGE OS.iso / lisp / wcl-21.lha / wcl-2.1 / doc / INSTALL < prev    next >
Text File  |  1992-09-10  |  2KB  |  74 lines
  1. WCL only runs on SPARCStations under SunOS 4.1 right now. 
  2. See wcl.text for porting information.
  3.  
  4. INSTALLATION
  5. ------------
  6.  
  7. If you just want to install WCL without thinking about anything else,
  8. cd to the main wcl directory and type "make install".  This
  9. will cause Lisp to compile and link itself from the sources.  You
  10. might want to read about configuration before doing this, however.
  11.  
  12. When the installation is complete, the newly built binaries will be in
  13. the bin directory and the binaries that came with the distribution
  14. will be in the dist-bin directory. You can delete the dist-bin
  15. directory if you want.
  16.  
  17. If you want to conserve disk space after WCL has been installed, you may
  18. delete everything but the lib, bin and include directories.
  19.  
  20. If you want to debug Lisp code, you should also install WGDB,
  21. a modified version of GDB, which is distributed separately.
  22.  
  23. Refer to doc/wcl.text for information about running and debugging WCL.
  24.  
  25. CONFIGURATION
  26. ---------------------
  27.  
  28. The CONFIGURATION file in the top-level of the distribution tree
  29. controls how WCL will be rebuilt from sources when doing an
  30. installation. The value of the CC parameter controls which C compiler
  31. will be used by WCL.  Either Sun cc or GCC 2.1. can be used, but GCC
  32. 2.1 is preferred because it can generate optimized,
  33. postition-independent code WITH debugging information.
  34.  
  35. Note that code compiled by gcc cannot currently be loaded into a WCL which has
  36. been built using Sun cc because the gcc library routines are not available.
  37.  
  38. INSTALLING GCC2.1
  39. ------------------
  40.  
  41. configure sun4
  42. <edit make file and change "prefix" from /usr/local to whatever you want>
  43. make stage1
  44. make CC=stage1/gcc CFLAGS="-g -O -Bstage1/" LANGUAGES=c
  45. make CC=stage1/gcc install LANGUAGES=c
  46.  
  47.  
  48. INSTALLATION PROBLEMS
  49. ---------------------
  50.  
  51. Running out of swap space is the most common installation problem.
  52. The obvious answer is to get more space.
  53.  
  54. If you cannot find enough swap space, you can use the binaries
  55. provided in the distribtion. However, you will have to set the
  56. environment variable LD_LIBRARY_PATH to the name of the directory
  57. containing the WCL library. 
  58.  
  59. Don't worry if you see a message like:
  60.  
  61.    ld.so: warning: /usr/lib/libc.so.1.5 has older revision than expected 6
  62.  
  63. when the distributed binary starts up.
  64.  
  65.  
  66. CROSS COMPILATION
  67. -----------------
  68.  
  69. WCL can be cross compiled using Lucid Common Lisp. The resulting
  70. binary can then be used to rebuild itself.  The src/build directory
  71. contains some useful scripts.
  72.  
  73.  
  74.